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Part 1. Token ring 


The topics here teach you how to provide token-ring support for TCP/IP and SNA. 
Existing installations: 


Users who have existing token-ring line descriptions can|[change] them to take advantage of the 100 
megabit per second (Mbps) card. If you use the line description with TCP/IP, you must also[assign]it toa 
TCP/IP interface. 


Token-ring support information: 


To configure and manage token-ring support on your server, read this information: 


[Understand token- ring support} to successfully configure your system. 


[Plan] how to configure your connection after understanding how your system supports token ring. 
token-ring support after planning your connection configuration. 
|Manage|token-ring support after you have configured it. 
fue our system to increase performance after the configuration of token-ring support. 
t]to locate problems and solutions. 


Code disclaimer information 


This document contains programming examples. 


IBM grants you a nonexclusive copyright license to use all programming code examples from which you 
can generate similar function tailored to your own specific needs. 


All sample code is provided by IBM for illustrative purposes only. These examples have not been 
thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, 
or function of these programs. 


All programs contained herein are provided to you "AS IS” without any warranties of any kind. The implied 


warranties of non-infringement, merchantability and fitness for a particular purpose are expressly 
disclaimed. 
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Chapter 1. Print this topic 


To view or download the PDF version, select}Token ring} (about 564 KB or 48 pages). 


To save a PDF on your workstation for viewing or printing: 

Open the PDF in your browser (click the link above). 

In the menu of your browser, click File. 

Click Save As... 

Navigate to the directory in which you would like to save the PDF. 
Click Save. 


aroONs 


If you need Adobe Acrobat Reader to view or print these PDFs, you can download a copy from the 
(www.adobe.com/prodindex/acrobat/readstep. htm)" 
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Chapter 2. Token-ring support 


To properly provide token-ring support, you must understand the information that follows. Then you|plan| 
how to configure the system. To understand token-ring support, read this information: 

. Whatherensing funcionélre supported by your system? 

* What determines a successful|connection}: 
connects SNA to token ring 
* What determines your|maximum frame size} 


Supported token-ring functions 


Your server supports a range of token-ring technologies that support speeds of 4 Mbps, 16 Mbps, and 100 
Mbps. These technologies support the IEEE 802.5 standard. The 100 Mbps token-ring input/output adapter 
(IOA) supports the High-Speed Token-Ring IEEE 802.5 standard that specifies 100 Mbps operation. 


The 100 Mbps token ring IOA: 


Your system can use the PCI 100/16/4 MB Token-Ring Adapter to support faster networking. The IOA 
supports many protocols including TCP/IP and SNA. It is compatible with earlier devices, but does not 
support token-pipes or multilink. The adapter is also known as the 2744 IOA. The IOA introduces these 
new functions: 

¢ Automatic ring-speed sensing (automatic sense) enables your system and the switch to find the 
highest common ring speed to use between them. The destination does not need to match this speed, 
because the switch manages the differences in speed. 

* Duplex mode negotiation enables your system and the switch to agree on the duplex mode to use 
(half or full duplex). The available duplexing modes are dependent on the ring speed that you use. At 4 
Mbps or 16 Mbps you can use either half-duplex or full-duplex mode. At 100 Mbps you must use 
full-duplex mode (the speed for each channel (transmitting or receiving) is 100 Mbps). 


Early token release: 


Only 16 Mbps rings that use half-duplex mode can use the early token release function. This function 
reduces the time the next device on the same ring waits for a free token. Early token release enables the 
transmitting device to release the free token right after sending a frame. Thus, the next device receives the 
free token sooner and can thereby transmit a frame. This function is beneficial only in rings where the time 
to transmit a frame is shorter than the travel time of the frame. That is, the time for the frame to travel 
completely around the ring. 


Connection establishment between LAN devices 


If you use SNA with a LAN protocol, read this information to successfully connect to a device. The correct 
relationship between a line description and a controller description helps to ensure connection 
establishment. A controller description determines which line descriptions your system uses. Therefore, 
you must ensure that the controller description refers to the correct line description. 


Also, a line description governs the number of active controllers that can access it. By making the number 
too small, you may prevent the controller description from accessing the line description. Therefore, you 
should ensure a large enough value to allow the controller description access to the line description. 


Besides the correct relationship between the line and controller descriptions, the descriptions must also 
contain the correct information to ensure connection establishment. This information discusses some of the 
connection information that you_are responsible for: 

- Decide how a device should|identify| itself. 

* Decide whether a device will the connection request or not. 
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How LAN devices identify themselves 


During the connection process, your system sends information to the remote device, which the device 
uses to ensure connection to the correct system. The remote device also sends information to your 
system, which your system also uses to ensure the connection to the correct device. Your system 
compares the exchanged information against the information that is contained in the line and controller 
descriptions. If a match occurs and other connection values are correct, the connection process continues. 
Likewise, the remote device performs a similar process. 


Your system and the remote device use two verifications during the connection process to ensure 
connection to the correct device. One verification (required), matches the line description information and 
controller description information with the connection information that the remote device sent. If a match 
occurs, your system continues with the connection process. 


This list shows the information that the remote device sends: 

¢ The address associated with the input/output adapter (IOA) on the remote device. This address is either 
the preset address or the locally administered address. 

* The source service access point|(SSAP)|on the remote device. 

* The destination service access point 


The other verification matches the jexchange identifier} values. For advanced program-to-program 


communications (APPC), this verification is optional. SNA hosts that use parallel connections require this 
verification. 


SNA Exchange identifiers (XIDs) 

To establish a connection, your system and the remote device exchange information that includes the 
exchange identifiers (XIDs). SNA hosts that use parallel connections require the XIDs. You define the XIDs 
in the controller description. Typically, during the connection process your system conducts an initial poll 
with NULL XIDs to determine whether the remote device is active or not. If the remote device does not 
respond to the poll within the specified time period, your system can send another XID to the device. If the 
remote device responds to the poll, your system and the remote device exchange XIDs and establish the 
link. 


The controller description for SNA hosts names the XID value as the local exchange identifier. The APPC 
controller description names the XID value as the exchange identifier. 


Which LAN device initiates the connection 


In an SNA environment you can determine who initiates the connection request and who waits for an 
incoming connection request. To have your system initiate the connection, configure the controller 
description to dial the destination. If no connection is established, your controller description switches to 
answer mode (where it waits for a device to dial into your system). 


To have your system wait for incoming calls, configure the controller description to answer the incoming 
calls. You seoiel rocelie make connection requests and to have the system wait for 
incoming connection requests. You specify one of these modes through the Initial connection (INLCNN) 
field of the controller description. 


Dial mode (SNA) 

You use dial mode (that is used by SNA controller descriptions) to send a connection request to a remote 
device. Dial mode starts when varying on the controller description. During the dialing process, the system 
polls the remote device to determine if the device is ready to transmit. If the remote device is ready, the 
connection process continues. Successful connection is still possible even if the local and remote devices 
dial each other simultaneously. 


These controller description fields control the frequency and duration of the polling: 
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¢ LAN connection retry (_LANCNNRTY) determines the number of times your system polls the remote 
device. 
¢ LAN connection timer (LANCNNTMR) determines the length of time between each poll. 


If the remote device answers the poll within the time that these parameters specify, your system proceeds 
with establishing the connection. If not, your system sends an inquiry message (CPA58E0 or CPA57EF) to 
the system operator message t ueue. This message indicates that a connection attempt failed and that the 


controller description is now inJanswer mode 


Answer mode (SNA) 

If you specify answer mode, the input/output adapter (IOA) cannot send connection requests, but can 
respond to incoming connection-requests. Systems with controller descriptions that are configured with dial 
mode send the connection requests. The controller description must be varied on before the system can 
respond to a connection request. 


SNA connections to LAN protocols 


You or the system can connect SNA to a LAN protocol by using one or more service access points 
(SAPs). Multiple SAPs allow you to have multiple connections between SNA and a LAN protocol, thus 
permitting multiple communication paths between independent applications. 


You or the system specifies the SAPs to use in the line and controller descriptions. For SNA, the system 

can automatically create one SAP value (the default value). There may be cases where you want to 

change this value or have additional SAPs: 

¢ The remote system does not use the default source service access point (SSAP). 

* You want parallel station-to-station connections between adapters. This may be desirable if you link two 
applications that require different controller descriptions. 

* You want station-to-station connections to the same adapters. You may want to do this to configure 
multiple SAPs to test an application on a single system. 


If you plan to change the SAP defaults, see |your SAPs| for guidelines and other information. 
SSAP and DSAP: 


Local SAPs are known as source service access points (SSAPs). The remote SAPs are known as 
destination service access points (DSAPs). Your system sends data from a SSAP to a DSAP. 


Your SNA service access points 


If you decide to change the default SNA service access points (SAPs) or add more SAPs, you must define 
them in the line and controller descriptions. On the system, you define the source SAPs, or in other words 
the source service access points (SSAPs), You can specify up to 24 SSAPs per line description when you 
define the SAPs. The SSAPs that your controller description uses must come from the line description that 
is associated with the controller description. 


Your controller description specifies the destination service access points|(DSAPs)jto which your line 
description can connect. 


You should remember this point when specifying your SSAPs and DSAPs: your DSAP is the SSAP of the 
remote device, and the DSAP of the remote device is your SSAP. For example, this table shows how to 
define the SSAPs and DSAPs when your SSAP is 04 and the remote SSAP is 08: 


Table 1. Local and remote SSAPs and DSAPs 

Local device Remote device 
SSAP = 04 SSAP = 08 
DSAP = 08 DSAP = 04 
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For SNA, you must use certain SSAP values. You can find the help for selecting these values by pressing 
F1 (Help) while your cursor is on the SSAP list field of the line description. 


Maximum frame size of token ring 


This page contains a few guidelines and tips for specifying the maximum frame size. First some 
background information to help you understand the reasons for the guidelines and tips. 


Larger frames require less processing overhead than the same data that is divided up among many 
smaller frames. Therefore, the use of larger frame sizes can improve the performance of your system. 
However, the frame size that you select can be reduced if other entities within the communications path 
cannot support the frame size. 


Maximum frame size fields: 


You can use these fields to specify the maximum frame size (the parentheses show location of the field): 

* Maximum frame size (line description) affects all devices that use the line description. 

¢ Source service access point (SSAP) maximum frame size (line description) affects only devices that use 
the SSAP and line description. 

* Maximum frame size (controller description) affects all line descriptions that are associated with the 
controller description. 


If you specify a maximum frame size in two or more of these fields, the system selects the smallest size. 

To ease the frame size configuration of your line and controller descriptions, use these guidelines: 

* Use the largest possible frame size that the network connection supports. 

¢ Specify the maximum frame size only in the Maximum frame size field of the line description. The 
system then uses this value for all other maximum frame size fields. 

* Specify a size smaller than the maximum frame size of the IOA if you receive a frame rejection error. 


Reduction of selected maximum frame size: 


Other entities within the communications path can reduce your maximum frame size if they cannot support 

it. Some of these entities are: 

¢ Remote IOAs or other devices: Some support only smaller maximum frame sizes. 

¢ Line or controller description: These descriptions on the remote system sometimes specify a smaller 
maximum frame size. 

¢ Devices: Some do not support maximum frame size negotiations. 


Solution: 
If negotiation does not produce a common frame size, a frame reject (FRMR) condition occurs, and your 


system sends message CPA58E2 to message queue QSYSOPR. If you cannot change the frame size of 
the other entities, use an acceptable maximum frame size value in your line or controller description. 
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Chapter 3. Plan for token-ring support 


To make the configuration of token-ring support easier, you need to make some decisions now about how 
to configure your connections. You can make decisions about these items: 


* When do you need to use a smaller|maximum frame size/ 


¢ What kind of/LAN IOA address} should you use? 


Maximum LAN frame size 


The larger your frame size, the more data your system can pack into it. Hence, your data throughput can 
increase. Usually, you set the maximum frame size to the largest size that is supported by your 
input/output adapter (IOA). However, a device will drop the frame if it cannot support your frame size. If 
you cannot configure the device to support your frame size, change your maximum frame size to a size 
that the device can support. 


You can change one or more of these maximum frame size fields (the parentheses contain the location of 
the field): 

* SSAP maximum frame size (line description) 

* Maximum frame size (line descriptions for token ring and gigabit Ethernet networks) 

* Maximum frame size (controller description) 


The maximum frame size used by your system during the connection process will be the smallest of these 
fields. 


LAN IOA addresses 


In an SNA environment, you can determine the address for each input/output adapter (IOA). You can use 

one of two addresses: 

* The manufacturer-assigned address that is otherwise known as the burned-in address, preset address, 
or universally-administered address. 

* The locally administered address. 


You define the locally administered address, and the system associates it with the adapter. Using a locally 
administered address minimizes the reconfiguration work when you replace the adapter. 


For example, if you use the burned-in address of the adapter, you must configure this address into every 
device that communicates with the adapter. When you replace the adapter, you must go back to each 
device and reconfigure them with the burned-in address of the new adapter. You cannot assign the 
burned-in address of the replaced adapter to the new adapter. 


You can avoid the reconfiguration work by associating a locally administered address with the adapter and 
using this address in all devices that communicate with the adapter. When you replace the adapter, 
associate the locally administered address with the new adapter. Since the devices already have the 
locally administered address, you do not need to reconfigure them. 


Note: No two adapters can have the same address in the same network. 
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Chapter 4. Configure token-ring support 
After[understanding| and [planning] your token-ring support, you are ready to configure token ring on the 


system. To configure token-ring support for TCP/IP or SNA, read this information: 
Configuring TCP/IP over token ring 


Configure TCP/IP over token ring 


You can use iSeries Navigator to configure token-ring support for TCP/IP. To do this, do these steps: 

1. If you have not done so already, [install Series Navigator. 

2. iSeries Navigator can use an existing line description. To use an existing line description, it. 
Then return here to continue these steps. 

3. In iSeries Navigator, expand the server that will provide token-ring support for TCP/IP. 

4. Use the LAN Configuration Wizard to [configure a new TCP/IP interface] to use token ring with TCP/IP. 
As you create a new token-ring line for the 100 Mbps card while creating the interface, remember 
these items about the duplex modes: 
¢ At 4 Mbps or 16 Mbps you can use half-duplex or full-duplex modes. 
¢ At 100 Mbps you can only use full duplex. 

5. If you did not start the TCP/IP interface, you can do so now by[enabling it] to accept connections. 


Configure SNA over token ring 
To provide token-ring support for SNA, do these steps: 
1. |Create the token-ring line description] Ensure the correct configuration of these fields when you create 


the line description: 

* If the system uses this line description to communicate with an SNA host through a parallel 
connection, define a value other than *LIND in the Exchange identifiers field. 

¢ APPN and APPC connections use fields Link speed through Autodelete controller. You can use the 
defaults or press F1 (Help) for more information about each field. 

¢ If you want the system to create the APPC controller description when a call comes in, specify *YES 
in the Autocreate controller field. If you specified *YES, skip to step 


2. |Create the controller description 
3. If your controller description does one of these, you must}create a device description 


* Specifies “NONE in the Autocreate device field. 
* Specifies *NO in the APPN-capable field (this applies only to APPC controller descriptions) 
4. |Enable|the descriptions to accept connections. 


If you need help with configuring the token-ring support for your SNA environment, see 
Configuring SNA over token ring 


Create the token-ring line description 


To configure a token-ring line description, see the information on this page. The information assumes that 
you are not using token-ring card with Netfinity. 


* TCP/IP: To use TCP/IP over token ring, see|Configuring TCP/IP over token ring 


¢ SNA: To configure a token-ring line description through the server console, use the Create Line 
Description (Token Ring) (CRTLINTRN) command and follow the steps in this page. 


Note: This page explains some of the fields that require additional information. You can also find other 
help information by pressing F1 (Help) when your cursor is on the field in question. 


1. an input/output adapter (IOA) to use with your line description. If you are not familiar with the 
capabilities of the IOA, see|Token-ring IOAs 
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You are now at the Create Line Description (Token Ring) (CRTLINTRN) display. Notice that the 
system copied the name of the IOA to the Resource name field. 


Do not press Enter while at this display unless instructed to do so; otherwise, you may exit the 
display. To move from field to field, move your cursor or press the Tab key. 

Type a name for your line description into the Line description field. 

Press Enter twice, and then F10 (Additional fields). 

Indicate the appropriate number of_active controller descriptions that_can use the line description in 
the Maximum controller field. See Connection establishment between LAN devices|tor more 
information about accessing a line description through a controller description. 

5. In the Line speed field, indicate the speed of the IOA. 


PON 


Note: You enable|automatic ring-speed sensing} (automatic sense) when specifying “AUTO or 100M. 
Automatic sense starts initially at 100 megabit per seconds (Mbps). To use automatic sense 


successfully, you must enable it only on your system or on the switch to which your system 
connects. That is, do not enable both devices; otherwise, the correct speed may not be 
selected. 

6. Select the duplex mode to use with your IOA. 


Note: |Duplex mode negotiation] occurs when you specify “AUTO or *FULL. Duplex mode negotiation 


initially starts at full-duplex mode. The switch must support duplex negotiation before you can 


successfully use this function. If you are not familiar with the capabilities of the IOA, see 
Token-ring IOAs 


7. Specify the largest possible frame size in the field. 
8. Assign an address to the IOA by using the Local adapter address field. 


To determine whether to use the burned-in address of the adapter or a locally administered address, 
read|LAN IOA addresses} To use the burned-in address, accept the default value of *ADPT. 


To specify a locally administered address, find a valid address and enter it into the field. To find a 
valid address, move your cursor to the field and press F1 (Help) for more information. 

9. List all the source service access points |(SSAP)] that your controller should use in the Source service 
access point field. Accept the default value of *“SYSGEN or specify your SSAPs. If you define the 
SSAP values, move the cursor to the field and press F1 (Help) to help determine what values to use. 


For more information about whether you or the system should define the service access points 
(SAPs), see 

10. Leave the SSAP|maximum framel|field blank unless you need to enter a value. 

11. If you use this line description with half duplex mode and with a 16 Mbps ring, you can take 
advantage sileary (onsneleced To do this, specify *YES in the Early token release field. 

12. Press Enter to create the line description. 

13. If an error occurs, the system may present to you some options to correct the error. Select the option 
that you desire. You can also move your cursor to the error message and press F1 (Help) to see the 


cause of the error and the possible fixes. 
14. Press F3 (Exit). 


Token-ring IOAs 
This table shows the duplex modes and maximum frame sizes that are supported by the input/output 
adapters (IOAs): 


Table 2. Duplex modes and maximum frame sizes supported by the token-ring IOAs. 


1OA Duplex modes supported Maximum frame sizes 
100 Mbps 16/4 Mbps 100 Mbps 16 Mbps 4 Mbps 
2619, 2626 N/A Half N/A 16393 4060 
6149, 2724 N/A Full or half N/A 16393 4060 
2744 Full Full or half 16393 16393 4060 


N/A - Not applicable 
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Selecting a LAN IOA 

Before creating your line description, you must select the input/output adapter (IOA) to use with it. Use the 
Work with Hardware Resources (WRKHDWRSC) command to identify the name of your IOA and select 
the IOA. To do this, do these steps (even if you know the name of the IOA): 


1. 


3. 
4. 
5 


Type WRKHDWRSC “*CMN and press Enter. 


A list appears that shows the attached iSeries communications resources, and their type numbers, 
operational statuses, and descriptive text. 

Locate an IOA by looking in the descriptive text column for a phrase that describes a port for your LAN 
type. For example, if you use Ethernet, look for "Ethernet Port.” If you use token-ring, look for 
"Token-ring port.” 

Once you find an IOA, move your cursor to its Opt field. 

Type 5 (Work with configuration descriptions) and press Enter. 

Type 1 (Create) and press Enter. 


Create the SNA controller description 


The controller description indicates the remote devices to which the system connects. To create a 
controller description to use with your LAN adapter, do these steps: 


1. 


our wh 


See |Creating an APPC controller description} to find out which create controller command to use. Then 


return here to configure the description. 

Type the name of the command to use and press F4 (Prompt). 

Type the name of the controller description into the Controller description field. 

Specify *LAN in the Link type field. 

Press Enter three times. 

The system displays more fields that may require this information (for more help, press F1 (Help) while 

your cursor is on the field): 

¢ Switched line list specifies one or more line descriptions that should use your controller 
description. For more information about the relationship between the line and controller descriptions, 
see 

* Remote control point names the local control point of the remote iSeries system. Use the Display 
Network Attributes (DSPNETA) command on the remote system to view its local control point name. 

¢ Exchange identifier contains the [exchange identifier] for your system. APPC requires the ID. This 
ID has two parts. To determine the value for the first part, press F1 (Help) when your cursor is on 
this field. You can get the value for the second part from the line description on the remote system 
that is used to connect to your system. To understand the purpose of exchange identifiers, read 

* Local exchange identifier identifies your iSeries to the host system. This field exists only in the 
host controller description. Parallel connections between your system and an SNA host require an 

* Initial connection determines whether the controller description [initiates] connection requests 
or waits for incoming connection requests[(*ANS)} 


If you specify *DIAL and want to adjust the polling duration or frequency, change the LAN 
connection retry |(_LANCNNRTY)| or LAN connection timer |(LANCNNTMR)/ field. 
¢ LAN remote adapter address contains the address of the remote input/output adapter (IOA). To 


find this address, see|viewing the address of your adapter} If you are using the preset address of 


the adapter, read|LAN IOA addresses|to minimize your reconfiguration work. 


¢ LAN [DSAP] contains the source service access point|(SSAP)| value from the controller description 
that is on the remote device. For more information about service access points (SAPs), see SNA 


connections to LAN protocols 


¢ LAN ISSAP} contains a value from the SSAP list of the line description that is associated with this 
controller description. 
(Optional) For detailed information about all the parameters and their dependencies, see the chapter 


about communications controller descriptions in}OS/400 Communications Configuration i : 
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8. Press Enter three times to create the description. 


Create the SNA device description 


The device description describes the communications device that is used by the remote device. There are 
no LAN-specific parameters in the device description. To create the SNA device description, do these 
steps: 

1. To create the device description, find the create command to use in|Creating APPC device descriptions| 

(this information also has other commands for APPN devices, SNPT devices, and so forth). Then 

return here to configure the description. 

Type the name of the command to use and press F4 (Prompt). 

Type the name of device description into the Device description field. 

Complete these fields as described: 

* Remote location is the name from the Local location field of the device description that is on the 
remote device. If the Local location field contains *NETATR, use the Display Network Attributes 
(DSPNETA) command at the remote device. Use this command to view the name that is specified 
by the Default local location field. 

¢ Remote network identifier is the network identifier of the remote iSeries system. To find this value, 
use the Display Network Attributes (DSPNETA) command at the remote system to locate the Local 
network ID field. APPC device descriptions use the Remote network identifier field. 

5. (Optional) For detailed information about all the parameters and their dependencies, see the chapter 


about communications device descriptions in}OS/400 Communications Configuration “>. 


6. Press Enter twice to create the description. 


PoP 


Examples: Configure SNA over token ring 


The examples here describe the dependencies of a parameter or the required parameter values for 
various SNA network environments. 


This |disclaimer information|pertains to code examples. 


This command creates the TOKENRING1 line description that all the examples use: 


CRTLINTRN LIND(TOKENRING1) RSRCNAME(TRN_IOA) LINESPEED(16M) 
MAXFRAME (16393) ADPTADR(400003190001) EXCHID(05600000) 
SSAP((04 *MAXFRAME *CALC) (08)) 


This figure shows the network used by the examples: 
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Figure 1. Example token-ring network 


These are the SNA examples: 
* |Connecting a server to another server 
¢ |Connecting the server to itself 
* |Connecting an server to a System/36 


¢ |Connecting an server to a 3745 host 
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Connecting an server to a 3174 Model 1L gatewa’ 
Connecting an server to a 3174 subsystem control unit 


Creating parallel connections to a host 


For APPN, see|APPN configuration examples 


Example: Connect a server to another server 


This example shows how to create an APPC over token-ring connection from your server to another 
server. The name of the local server is LOCAL, and the name of the remote system is REMOTE. 


Note: Since all the examples use the same token-ring line description, this example discusses only the 
controller and device descriptions. 


Focus on these points in this example: 


¢ The service access points (SAPs) in the controller descriptions. For more information about SAPs, read 
SNA connections to LAN protocols 


¢ The adapter address used by a controller description must match the address that is used in the line 
description on the remote device. This table shows the adapter addresses that are used by the line and 
controller descriptions on both systems. 


Table 3. Local and remote adapter addresses 


LOCAL REMOTE 
Adapter address in line description 400003190001 400003200001 
Adapter address referred to by the controller 400003200001 400003190001 
description 


* The way a system identifies the other system to which it connects. Both sides must use the same 
method. These are the methods: 
— Only use the Remote exchange identifier parameter. 
— Use the Remote network identifier and the Remote control point name parameters. 


In this example, each system uses the Remote network identifier and Remote control point name 
(RMTCPNAME) parameters to indicate the system to which it connects. 


Note that within a system the remote network identifier must be the same in the controller and device 
description. Because the example uses the default value of *NETATR for the Remote network identifier 
parameter, this parameter is not shown. 


Get the value for the Remote control point name parameter from the other system. To do this, use the 
Display Network Attributes (DSPNETA) command on the other system and locate the Local control point 
name field. 


TOKENRING2: 


This disclaimer information| pertains to code examples. 


The example uses this line description on the remote system: 


CRTLINTRN LIND(TOKENRING2) RSRCNAME (TRN_IOA) LINESPEED (16M) 
MAXFRAME (16393) ADPTADR(400003200001) EXCHID(05600000) 
SSAP((04 *MAXFRAME *CALC) (08 *MAXFRAME *CALC)) 
TEXT('Line description for 400003200001') 


Controller descriptions: 


These examples show the controller descriptions that are used on the local and remote systems. 
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CRTCTLAPPC CTLD(LOCAL_CD) LINKTYPE(*LAN) SWTLINLST QTOKENRING1) 
DSAP (04 


RMTCPNAME(REMOTECP) ADPTADR(400003200001 
SSAP(08) TEXT('Controller description on LOCAL') 


CRTCTLAPPC CTLD(REMOTE_CD) LINKTYPE(*LAN) SWTLINLST(TOKENRING2) 
RMTCPNAME(LOCALCP) ADPTADR(400003190001) DSAP(08) 
SSAP(04) TEXT('Controller description on REMOTE') 


Device descriptions: 


In the device descriptions, the Remote network identifier (RMTNETID) parameter should match the local 
network-identifier of the remote system. You must use the Display Network Attributes (DSPNETA) 
command on the remote system to view the local network-identifier. 

CRTDEVAPPC DEVD(LOCAL_DD) RMTLOCNAME (REMOTE) LCLLOCNAME (LOCAL) 


CTL(LOCAL_CD) MODE (BLANK) 
TEXT('APPC device description describing system REMOTE') 


CRTDEVAPPC DEVD(REMOTE_DD) RMTLOCNAME (LOCAL) LCLLOCNAME (REMOTE) 
CTL(REMOTE_CD) MODE (BLANK) 
TEXT('APPC device description describing system LOCAL') 


Example: Connect the server to itself 

This example connects your system to itself. That is, the tokens travel around the local token ring network 
before returning to your system. You can do this to test an application within your system before testing it 
in the network. Since all the examples use the same token-ring line description, this example discusses 
only the controller and device descriptions. 

Two sets of controller and device descriptions connect your system to itself. The first set|dials| (initiates) a 
connection request, and the second colleraword (accepts) the connection request. 

In this example, focus on these points: 

¢ Use a different source service access point (SSAP) for each controller. 


¢ Use the same adapter address in both controller descriptions. 
¢ Use dial mode in one controller description and answer mode in the other. 


| This|disclaimer information|pertains to code examples. 


Dial command set: 


CRTCTLAPPC CTLD(DIAL_CD) LINKTYPE(*LAN) APPN(*NO) INLCNN(*DIAL) 
sin sr OER ADPTADR(400003190001) 
DSAP(08) SSAP(04 
TEXT('Link from SAP 04 to 08') 


CRTDEVAPPC DEVD(DIAL_DD) RMTLOCNAME(ANS) LCLLOCNAME (DIAL) 
CTL(DIAL_CD) MODE(BLANK) APPN(*NO) 


Answer command set: 


CRTCTLAPPC CTLD(ANS_CD) LINKTYPE(*LAN) APPN(*NO) INLCNN(*ANS) 
SWTLINLST(TOKENRING1) ADPTADR (400003190001) 
DSAP(04) SSAP(08) 
TEXT('Link from SAP 08 to 04') 


CRTDEVAPPC DEVD(ANS_DD) RMTLOCNAME (DIAL) LCLLOCNAME (ANS) 
CTL(ANS_CD) MODE(BLANK) APPN(*NO) 


Example: Connect a server to a System/36 


| This|disclaimer information|pertains to code examples. 
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This example uses APPC to connect your server to a System/36 system. Since all the examples use the 
same token-ring line description, this example discusses only the controller and device descriptions. On 
the remote system, the System/36 administrator must configure an APPC-subsystem member and a 
token-ring-line member to connect to your system. 


The controller and device descriptions must disable APPN and not use remote IDs by using the APPN and 
RMTNETID parameters like this: 
CRICTLAPPC CTLD(CTL_36) LINKTYPE(*LAN) APPN(*NO) 

SWTLINLST(TOKENRING1) RMTNETID(*NONE) EXCHID(03E00000) 

ADPTADR (40000000400 

TEXT('APPC controller description describing System/36') 


CRTDEVAPPC DEVD(DEV_36) RMTLOCNAME(SYSTEM36) RMTNETID(*NONE) 
MODE (BLANK) APPN(*NO) 


Example: Connect a server to a 3745 host 


This example connects your system to a 3745 host. You will also find more information about configuring 

the host at the end of this example. Focus on these points for this example: 

¢ The controller description destination service access point (DSAP) must specify 04 to connect to the 
host. The example does not show this parameter because 04 is the default. 

¢ The host can refer to only service access points (SAPs) 04 through 94; therefore, your service source 
access point (SSAP) must be within this range. The example does not show this parameter because it 
uses the default value of 04. 


This |disclaimer information|pertains to code examples. 


Controller description: 


CRTCTLHOST CTLD(TRLANHOST) LINKTYPE(*LAN) SWTLINLST (TOKENRING1) 
RMTCPNAME(LANAPPN) LCLEXCHID(*LIND) 


ADPTADR(4000000001580) NODETYPE(*LENNODE) 
TEXT('Controller description describing the 3745 host') 


Device descriptions: 


These are the device descriptions: 


CRTDEVHOST DEVD(TRLANEML) LOCADR(01) RMTLOCNAME (HOST) 
CTL(TRLANHOST) APPTYPE(*EML) 
TEXT('3270 emulation over TOKENRING1') 


CRTDEVHOST DEVD(TRLANPRT) LOCADR(OC) RMTLOCNAME (HOST) 
CTL(TRLANHOST) APPTYPE(*EML) EMLDEV (3287) 
TEXT('3270 printer emulation over TOKENRING1') 


CRTDEVDSP DEVD(TRLANDHCF) DEVCLS(*RMT) TYPE(3277) MODEL(*DHCF) 
LOCADR(02) CTL(TRLANHOST) TEXT('DHCF over TOKENRING1') 


Host configuration: 


On the host, you must generate a |physical]and a configuration before the system can connect to it. 
Example: Create a host physical-configuration 


This |disclaimer information|pertains to code examples. 


The network control program generation (NCP GEN) produces the physical configuration that is necessary 
to connect the 3745 Communication Controller to your server. The system administrator creates the NCP 
GEN for the GROUP and LINE macroinstructions. 
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You must ensure that the location address (_OCADD) parameter matches the Remote adapter address 
(ADPTADR) field of the controller description. This example shows the LOCADD parameter in bold: 


R1GO06P GROUP ECLTYPE=PHYSICAL 
R1080P LINE ADDRESS=(080, FULL) , LOCADD= (400000001580) , PORTADD=01, 
ISTATUS=INACTIVE 
R1080PA PU ADDR=01, ISTATUS=INACTIVE 
R1080PA1 LU LOCADDR=0, 
LUDR=NO 
R1GO06L GROUP ECLTYPE=LOGICAL, 
PHYPORT=80 
R108000 LINE 
R108000A PU MAXLU=32 
R108001 LINE 
R108001A PU MAXLU=32 
R108002 LINE 
R108002A PU MAXLU=32 
R108003 LINE 
R108003A PU MAXLU=32 
R108004 LINE 
R108004A PU MAXLU=32 
R108005 LINE 
R108005A PU MAXLU=32 
R108006 LINE 
R108006A PU MAXLU=32 
R108007 LINE 
R108007A PU MAXLU=32 


Note: This example is valid only on Network Control Program (NCP) Version 4.2 and Virtual 
Telecommunications Access Method (VTAM) Version 3.1.1. Different NCP or VTAM levels may 
require different parameters. 


Example: Create a host logical-configuration 

The network control program generation (NCP GEN) produces the logical configuration to connect the 
3745 Communication Controller to your server. This example configuration is valid only on Network Control 
Program (NCP) Version 4.2 and Virtual Telecommunications Access Method (VTAM) Version 3.1.1. 
Different NCP or VTAM levels may require different parameters. 


In this example, focus on these points: 
* Identifier block (IDBLK) and identifier number (IDNUM) 
* Dial number (DIALNO) 


The concatenation of the IDBLK and IDNUM values must match the Local exchange identifier 
(LCLEXCHID) value of your controller description. In this example, since the controller description specifies 
*LIND in field LCLEXCHID, the value comes from the Exchange identifier (EXCHID) field of the line 
description. 


The DIALNO parameter specifies the source service access point (SSAP) and the adapter address of your 
server. This is the format of DIALNO: 


aabb4000cccccccc 
This is the explanation of the format: 


* aa is the value of the PORTADD parameter that is specified in the |physical configuration 


* bb is the SSAP value from your controller description. 

* 4000cccccccc is the address of your adapter that is specified in the line description. In this example, 
the address is 400003190001 (see the ADPTADR parameter of line description]/TOKENRING1). 

This pertains to code examples. 


This logical configuration example shows the IDBLK, IDNUM, and DIALNO parameters in bold: 
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SW3270C VBUILD TYPE=SWNET, REQUIRED PARAMETER X 


MAXNO=8, * 
MAXGRP=5 

$3270C PU ADDR=C1, 8 BIT STATION UNIQUE ADDRESS X 
DISCNT=NO, ACCEPT DISCONTACT FROM PU (DEFAULT) X 
IDBLK=056, 12 BIT BLOCK NUMBER FOR STATION X 
IDNUM=00000, 20 BIT ID NUMBER FOR AS/400 SYSTEM X 
MAXDATA=1994, 
MAXPATH=8, MAXIMUM OF 8 STATIONS MAY BE CALLED X 
NETID=AS400, LOCAL NETWORK ID ON AS/400 X 
MAXOUT=7, 7 PIUS TO STATION BEFORE RESPONSE X 
PACING=7, NCP SENDS 7 TO LU AND MARKS FIRST X 
PASSLIM=7, MAXIMUM OF 7 CONTIGUOUS PIUS X 
PUTYPE=2, TYPE OF STATION CALLING IN X 
ISTATUS=ACTIVE, ACTIVATE WITH MAJOR NODE X 
MODETAB=LOGMOD38, I/S DEFINED TABLE * 
SSCPFM=USSSCS, VTAM TO STRIP/ADD MEDIA CONTROL CHAR = 
VPACING=7 VTAM SENDS 7 TO NCP AND MARKS FIRST 

S348L80 PATH GRPNM=R1GO06L,DIALNO=0104400003190001,PID=1 319-R1080 

SW327C01 LU LOCADDR=1, AS/400 LOCADDR VALUE X'@1' X 
ISTATUS=ACTIVE ACTIVATE WITH MAJOR NODE 

SW327C02 LU LOCADDR=2, AS/400 LOCADDR VALUE X'@2' X 
ISTATUS=ACTIVE ACTIVATE WITH MAJOR NODE 

SW327C12 LU LOCADDR=12, AS/400 LOCADDR VALUE X'@C' X 


ISTATUS=ACTIVE ACTIVATE WITH MAJOR NODE 


Example: Connect a server to a 3174 Model 1L gateway 
This [disclaimer information| pertains to code examples. 


In this example a 3174 Control Unit functions as a gateway to connect two systems that support different 
network architectures. You will also find an example to connect the gateway to your system at the end of 
this example. Since all the examples use the same token-ring line description, this example discusses only 
the controller and device descriptions. This example does not show the source service access point 
[(SSAP)] and destination service access point|(DSAP) parameters because they use the default values. 


Controller description: 


CRTCTLHOST CTLD(TRLANHOST2) LINKTYPE(*LAN) SWTLINLST (TOKENRING1) 
RMTCPNAME(*ANY) ADPTADR(400031740001) 


TEXT('Controller description describing the 3174 Gateway') 
Device description: 


Although this device description example is not specific to token-ring networks, you can use it to configure 
an emulation display: 
CRTDEVHOST DEVD(TRLANEML2) LOCADR(@1) RMTLOCNAME (HOST2) 


CTL(TRLANHOST2) APPTYPE(*EML) 
TEXT('3270 emulation for Host2') 


3174 configuration example: 


To connect the gateway to your system, see|Creating the NCP GEN for a 3174 gateway 


Example: Create the NCP GEN for a 3174 gateway 

The system administrator creates the network control program generation (NCP GEN) to connect your 
server to the 3174. You must ensure that the address specified by the control-unit address (CUADDR) 
parameter is correct. The last two characters of this parameter must match the Control Unit Address value. 
This value is specified in the Ring Address Assignment display and the Ring Transmission Definition 
display of the 3174. 
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Note: This example is valid on Network Control Program (NCP) Version 4.2 and Virtual 
Telecommunications Access Method (VTAM) Version 3.1.1. Different NCP or VTAM levels may 
require different parameters. 


This disclaimer information|pertains to code examples. 


This is the NCP GEN (the CUADDR parameter is in bold): 


R13B1 VBUILD TYPE=LOCAL 
R13BOA PU CUADDR=3B1, 


DISCNT=(NO,F), 
ISTATUS=ACTIVE, 
PUTYPE=2, 
SPAN=(SYSPGMR) , 
SSCPFM=USSSCS, 
VPACING=7 
R13B102 LU  DLOGMOD=P6ES2, 
ENCR=NONE, 
ISTATUS=ACTIVE, 
LOCADDR=2, 
LOGAPPL=SAMON, 
MODETAB=LOGMOD38, 
SPAN=(SYSPGMR) , 
SSCPFM=USSSCS, 
VPACING=7 


>< >< >< >< >< >< 


>< >< >< >< >< >< >< OD 


Example: Connect a server to a 3174 subsystem control unit 


This example connects your system to a 3174 (Model 3R or 53R) subsystem control unit. Since all the 
examples use the same token-ring line description, this example discusses only the controller and device 
descriptions. You will find suggestions for configuring the 3174 at the end of this example. 


This |disclaimer information|pertains to code examples. 


Controller description: 


CRTCTLRWS CTLD(TR_31274) TYPE(3174) MODEL(®) LINKTYPE(+LAN) 
SWTLINLST (TOKENRING1) ADPTADR(400031740004) 


TEXT('Controller description describing the 3174') 
Device description: 


This device description does not have any 3174 specific fields, so use whatever device descriptions you 
need: 
CRTDEVDSP DEVD(3279 DSP) DEVCLS(*RMT) TYPE(3279) MODEL(0) 


CTL(TR_3174) 
TEXT('Device description describing the 3279 display') 


3174 configuration suggestions: 


You should ensure that the token-ring display on the 3174 contains the correct adapter addresses. The 
address fields must match the local adapter address field of the line description and the remote adapter 
address field of the controller description. You should also ensure, that the maximum frame sizes match 
those that are specified by the Maximum frame size field of the line description. 


Example: Create parallel connections to a host 


This example connects your system to a host system through a 3745 Communications Controller by using 
parallel connections. Each connection has a separate instance of the logical link control and a separate 
bandwidth. Thus, communications can still occur even if one link becomes nonfunctional. 
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Since all the examples use the same token-ring line description, this example discusses only the controller 
and device descriptions. You can find the configuration for the 3745 controller in|/Example: Configuring the 
physical and logical parallel connections on the host system 

This disclaimer information|pertains to code examples. 


Controller descriptions: 


In this example, focus on these points: 

* The controller descriptions use the same line description. 

¢ The controller descriptions use different local exchange IDs. You must use exchange IDs to establish 
parallel connections. 

* The controller descriptions use different source service access points |(SSAPs)} 

¢ The 3745 Communications Controller requires that you specify 04 for the destination service access 


point|(DSAP) 
CRTCTLHOST CTLD(CTL_1A4 NKTYPE (*LAN) APPN(*NO) 
SWTLINLST (TOKENRING1) LCLEXCHID(056A001A) 


ADPTADR(400000001592) DSAP(04) SSAP(04) 
TEXT('Controller for the first link') 


CRTCTLHOST CTLD(CTL_2A) LINKTYPE(*LAN) APPN(*NO) 
SWTLINLST(TOKENRING1) LCLEXCHID(056A002A) 
ADPTADR(400000001592) DSAP(04) SSAP(08) 
TEXT('Controller for second link') 


Device descriptions for CTL_1A: 


These commands create the device descriptions that are used with the CTL_1A controller description: 


CRTDEVDSP DEVD(DSPAQQ1A02) DEVCLS(*RMT) TYPE(3279) MODEL(0) 
LOCADR(02) CTL(CTL_1A) APPTYPE(*NRF) 
TEXT('NRF device, LOCADDR 02') 


CRTDEVDSP DEVD(DSPAQ@1A03) DEVCLS(*RMT) TYPE(3279) MODEL(0) 
LOCADR(03) CTL(CTL_1A) APPTYPE(*NRF) 
TEXT('NRF device, LOCADDR 03") 


CRTDEVHOST DEVD(EMLA001A04) LOCADR(04) RMTLOCNAME (SWXIDA04) 
CTL(CTL_1A) APPTYPE(*EML) 
TEXT('Emulation display, LOCADDR 04') 


CRTDEVPRT DEVD(PRTAQQ1A05) DEVCLS(*RMT) TYPE(3287) MODEL(0) 
LOCADR(05) CTL(SWTRNCTLIA) APPTYPE(*NRF) 
LOGON('LOGON APPLID(NRF2AQ7) LOGMODE(SCSTRYR) ') 
TEXT('NRF printer, LOCADDR 05') 


Device descriptions for CTL_2A: 


These commands create the device descriptions that are used with the CTL_2A controller description: 


CRTDEVDSP DEVD(DSPAQ02A02) DEVCLS(*RMT) TYPE(3279) MODEL(0) 
LOCADR(02) CTL(CTL_2A) APPTYPE(*NRF) 
TEXT('NRF device, LOCADDR @2') 


CRTDEVHOST DEVD(EMLAQ02A04) LOCADR(04) RMTLOCNAME (SWXIDBO4) 
CTL(CTL_2A) APPTYPE(*EML) 
TEXT('Emulation display, LOCADDR 04') 


CRTDEVPRT DEVD(PRTAQ@2AQ5) DEVCLS(*RMT) TYPE(3287) MODEL(0) 
LOCADR(05) CTL(CTL_2A) APPTYPE(*NRF) 
LOGON('LOGON APPLID(NRF2AQ7) LOGMODE(SCSTRYR) ') 
TEXT('NRF printer, LOCADDR 05') 
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Example: Configure the physical and logical parallel connections on the host 
system 

This example shows the network control program generation (NCP GEN) that is created by a system 
administrator to connect the 3745 Communication Controller to the server. This example is valid on 
Network Control Program (NCP) Version 5.4 and Virtual Telecommunications Access Method (VTAM) 
Version 3.3. Different NCP or VTAM levels may require different parameters. 


This example shows one configuration for each connection and discusses two parameters: Identifier block 


(IDBLK) and identifier number (IDNUM). The concatenation of IDBLK and IDNUM must match the Local 


exchange identifier (LCLEXCHID) field of your controller description. The first configuration uses exchange 


ID 056A001A from controller description CTL_1A. The second uses 056A002A from CTL_2A. 
This disclaimer information|pertains to code examples. 
Configuration for the first connection: 


In this example, see the IDBLK and IDNUM parameters in bold: 


* 


SWXID VBUILD TYPE=SWNET, THIS IS A SWITCHED MAJOR NODE X 
MAXNO=64, MAXIMUM DIALNO PARAMETERS xX 
MAXGRP=64 MAXIMUM NUMBER OF LINE GROUPS 

SWXIDA PU ADDR=01, NOT CHECKED IF TOKEN-RING DEFINITION X 
DISCNT=NO, ACCEPT DISCONTACT FROM AS/400 X 
IDBLK=056, 12 BIT BLOCK NUMBER FOR AS/400 xX 
IDNUM=A001A, 20 BIT ID FOR THIS PU (AS/400 CTLD) X 
MAXDATA=1994, MAXIMUM FOR 4M TOKEN RING X 
MAXPATH=1, ONLY NEED ONE PATH STATEMENT X 
MAXOUT=7 , 7 PIUS TO DEVICE BEFORE RESPONSE X 
NETID=APPN, NETID OF AS/400 (IF DIFFERENT) xX 
PACING=0, PACING CAN BE ANY ACCEPTABLE VALUE X 
PASSLIM=7, MAXIMUM OF 7 CONTIGUOUS PIUS X 
PUTYPE=2, TYPE OF DEVICE CALLING IN X 
ISTATUS=ACTIVE, ACTIVATE WITH MAJOR NODE X 
MODETAB=LOGMOD38, ANY VALID LOGMODE TABLE * 
SSCPFM=USSSCS, VTAM TO STRIP/ADD MEDIA CONTROL CHAR * 


VPACING=0 VPACING CAN BE ANY ACCEPTABLE VALUE 


NOTE: YOU MUST DEFINE ENOUGH LOGICAL TOKEN-RING LINES TO ALLOW 
ALL PUs TO BE USED AT THE SAME TIME 


+ F F 


PATHA PATH GRPNM=R3G092L,DIALNO=0508400071032004 3 


* 


* SAME NUMBER OF LUs ON HOST AS DEVICES ON AS/400 


* 


SWXIDAO1 LU LOCADDR=1, FIRST AVAILABLE LOCAL ADDRESS X 
ISTATUS=ACTIVE ACTIVATE WITH MAJOR NODE 

SWXIDAO2 LU LOCADDR=2, FIRST AVAILABLE LOCAL ADDRESS X 
ISTATUS=ACTIVE ACTIVATE WITH MAJOR NODE 

SWXIDAO3 LU LOCADDR=3, FIRST AVAILABLE LOCAL ADDRESS X 
ISTATUS=ACTIVE ACTIVATE WITH MAJOR NODE 

SWXIDAO4 LU LOCADDR=4, FIRST AVAILABLE LOCAL ADDRESS X 
ISTATUS=ACTIVE ACTIVATE WITH MAJOR NODE 

SWXIDAO5 LU LOCADDR=5, FIRST AVAILABLE LOCAL ADDRESS X 
ISTATUS=ACTIVE ACTIVATE WITH MAJOR NODE 

SWXIDA06 LU LOCADDR=6, FIRST AVAILABLE LOCAL ADDRESS X 


ISTATUS=ACTIVE ACTIVATE WITH MAJOR NODE 
Configuration for the second connection: 


In this example, see the IDBLK and IDNUM parameters in bold: 
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KKK KKK KKK KKK KKK KKK KEK KKK KKK KK KKK KEKE KEKE KEK KKK KR KKK KKK KKK KKK KKK KK KKKKEKKERE 


SWXIDB = PU 


+ F FF 


ADDR=02, 
DISCNT=NO, 
IDBLK=056, 
IDNUM=A002A, 
MAXDATA=1994, 
MAXPATH=1, 
MAXOUT=7, 
NETID=APPN, 
PACING=0, 
PASSLIM=7, 
PUTYPE=2, 
ISTATUS=ACTIVE, 


MODETAB=LOGMOD38, 


SSCPFM=USSSCS, 
VPACING=0 


NOT CHECKED IF TOKEN-RING DEFINITION X 
ACCEPT DISCONTACT FROM AS/400 

12 BIT BLOCK NUMBER FOR AS/400 

20 BIT ID FOR THIS PU (AS/40@ CTLD) 
MAXIMUM FOR 4M TOKEN RING 

ONLY NEED ONE PATH STATEMENT 

7 PIUS TO DEVICE BEFORE RESPONSE 
NETID OF AS/400 (IF DIFFERENT) 
PACING CAN BE ANY ACCEPTABLE VALUE 
MAXIMUM of 7 CONTIGUOUS PIUS 

TYPE OF DEVICE CALLING IN 

ACTIVATE WITH MAJOR NODE 

ANY VALID LOGMODE TABLE 

VTAM TO STRIP/ADD MEDIA CONTROL CHAR 
VPACING CAN BE ANY ACCEPTABLE VALUE 


+ + >< >< >< OK OK OK OOK OOK OOK OK OO 


NOTE: YOU MUST DEFINE ENOUGH LOGICAL TOKEN-RING LINES TO ALLOW 
ALL PUS TO BE USED AT THE SAME TIME 
LABEL ON PATH MACRO MUST BE UNIQUE, IF SPECIFIED 


PATHB PATH GRPNM=R3G092L,DIALNO=0504400071032004 3 


SAME NUMBER OF LUs ON HOST AS DEVICES ON AS/400 


SWXIDBO1 LU 


SWXIDBO2 LU 


SWXIDBO3 LU 


SWXIDBO4 LU 


SWXIDBO5 LU 


SWXIDBO6 LU 
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LOCADDR=1, 
ISTATUS=ACTIVE 
LOCADDR=2, 
ISTATUS=ACTIVE 
LOCADDR=3, 
ISTATUS=ACTIVE 
LOCADDR=4, 
ISTATUS=ACTIVE 
LOCADDR=5, 
ISTATUS=ACTIVE 
LOCADDR=6, 
ISTATUS=ACTIVE 


FIRST AVAILABLE LOCAL ADDRESS X 
ACTIVATE WITH MAJOR NODE 
FIRST AVAILABLE LOCAL ADDRESS X 
ACTIVATE WITH MAJOR NODE 
FIRST AVAILABLE LOCAL ADDRESS X 
ACTIVATE WITH MAJOR NODE 
FIRST AVAILABLE LOCAL ADDRESS X 
ACTIVATE WITH MAJOR NODE 
FIRST AVAILABLE LOCAL ADDRESS X 
ACTIVATE WITH MAJOR NODE 
FIRST AVAILABLE LOCAL ADDRESS X 


ACTIVATE WITH MAJOR NODE 
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Chapter 5. Manage token-ring support 


After setting up token-ring support, you may need to manage this support. These are some of the tasks 
that you can do: 

your existing line description to use it with the 100 megabit per second (Mbps) card. 

your line description to a TCP/IP interface. 

[Enable]your configuration objects to accept connections after configuring the token-ring support. 

the burned-in address or locally administered address of your adapter. 


* See a list of commands that affect your|configuration objects 


Change the line descriptions to use token ring 


To use an existing token-ring line description with iSeries Navigator, you must first change the values for 
these fields: 

* Resource name 

¢ Address field 

* Duplex 

¢ Line speed 

* SSAP list (for TCP/IP only) 

* Link speed (Optional, used for APPN only) 


To change the fields, do these steps: 
A the line description. 
2. |Change| the field values. 


Vary off the line description: 


To vary off the line description, use the Work with Line Descriptions (WRKLIND) command like this: 
Type WRKLIND and press Enter. 

Locate your line description and place your cursor in its Opt field. 

Type 8 (Work with status) and press Enter. 

Type 2 (Vary off) and press Enter. 

If your line description does not vary off, place your cursor on the error message and press F1 (Help) 
to view more information about the error. (er tine siete ath aystertoublestoomna more 
troubleshooting help. 


6. If an error did not occur, press F3 (Exit) to exit the command, and continue with the next step (Change 
the field values). 


arons 


Change the field values: 


Now you must change the values in the fields by using the Change Line Description (Token Ring) 
(CRTLINTRN) command. To do this, do these steps: 
1. Record the name of the token-ring card by doing these steps: 
a. Type WRKHDWRSC *CMN and press Enter. 
b. Search the Type column to locate the desired token-ring card. 
c. Record the name of the card that is found under the Resource column. 
d. Press F3 (Exit). 
Type WRKLIND and press Enter. 
Locate the line description to change. 
Type 2 (Change) and press Enter. 
Type the name of the selected token-ring card into the Resource name field. 
In the Line speed field, indicate the speed of the input/output adapter (IOA). 


Note: You can enable automatic ring-speed sensing when specifying *AUTO or 


100M. Automatic sense starts initially at 100 Mbps. To use automatic sense successfully, you 
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must ensure that your system or the switch that the system connects to is enabled for 
ring-speed sensing. That is, you should enable ring-speed sensing only on one device; 
otherwise, an incorrect speed may be selected. 

7. Select the duplex mode to use with your IOA. 


Note: |Duplex mode negotiation] occurs when you specify “AUTO or *FULL. The negotiation starts 
initially at full-duplex mode. The switch must support this type of negotiation before you can 


successfully use this function. If you are not familiar with the capabilities of the IOA, see 
token-ring IOAs 


8. If you are using this line description with TCP/IP, ensure that source service access point |(SSAP) 
X'AA’ and its associated information are in the SSAP list field. 


9. If needed, specify a maximum frame size] If you are not familiar with the capabilities of the IOA, see 
token-ring IOAs 


10. Press Enter to save your changes, and then press F3 (Exit). 


11. Continue with the next step. If you are using this line description with SNA the description to 


accept connections. If you are using this line description with TCP/IP, jassign] it to an interface. 


Assign the token-ring line description to a TCP/IP interface 


After|changing the existing line description that will be used with the 100 Mbps adapter, you assign the line 


description to a TCP/IP interface. You do not need to do this if you are using the line description with SNA. 


Assigning the line description to a TCP/IP interface: 


You can assign the line description to a new or an existing TCP/IP interface through iSeries Navigator. To 
assign it to a new interface, you must follow the procedure in[Configuring TCP/IP over token ring|to create 
the interface. During this creation process, you must choose your description from a list of line 
descriptions. 


Note: If other entities know the burned-in address of your old adapter, you must replace that address with 
the address of the 100 Mbps adapter. This is required if you want them to communicate with the 
adapter. You can use a locally administered address to avoid these kinds of changes in the future 


(see |LAN IOA address}for more information). 


To associate your line description with an existing interface, do these steps: 

1. If you have not done so already, install] iSeries Navigator. 

2. If this is the first time you are using iSeries Navigator to access your server, use the wizard to 
configure] TCP/IP on the system. 

In the navigation bar, expand the server that contains the changed line description. 

Select Network—>Protocol. 

Right-click TCP/IP and select Interface. 

Double-click the interface that you will assign the line description to. 

Click the Resource tab and select your line description from the Line name option. 

Click OK, and then click OK again. 
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Enable objects to accept connections 


After configuring LAN support, you are ready to enable your configuration objects to accept connections. 
For SNA, you enable onary onitli line and controller descriptions. For TCP/IP, you can enable or(start| 
the interface. 


Vary on configuration objects: 

To accept connections, you must vary on the configuration objects by using the Work with Configuration 
Status (WRKCFGSTS) command: 

1. Type WRKCFGSTS “LIN and press Enter. 
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2. Locate your line description. 

3. Move your cursor to the Opt field of the line description, type 1 (Vary on), and press Enter. 

4. If the line description does not vary on successfully, press F3 (Exit). Then you should read [Display] 
fresesce qeded understand how to view the error messages and to find possible solutions. 

5. Press F3 (Exit). 


If the line description varied on successfully, you should do the same for the controller description if you 
created one. Vary on the description by using the same instructions for varying on the line description. 
Instead of specifying *LIN for the WRKCFGSTS command, you must specify *CTL. 


Start the TCP/IP interface: 


To enable the interface, use iSeries Navigator to do these steps: 
1. In iSeries Navigator, Expand the server that contains the TCP/IP interface to start. 
2. Select Network—>Protocol. 
3. Right-click TCP/IP and select Interface. 
4. You can start the interface now, or every time TCP/IP starts. 
a. To start the interface now: 
1) Select an inactive interface. 
2) Click Start. 
3) Click OK to close the dialog box. 
b. To start the interface every time TCP/IP starts: 
1) Double-click the interface. 
2) Select Start interface when TCP/IP is started. 
3) Click OK. 


View the address of your LAN IOA 


When configuring a controller description, you must specify the address of the remote input/output adapter 
(IOA). On the remote system, do these steps to view the locally administered address or the preset 
address: 


Viewing the locally administered address: 


To view the locally administered address, do these steps: 

1. Type DSPLIND description_name (where description_name is the name of the description to be 
displayed) and press Enter. 

2. Locate the Local adapter address field to view the address of the adapter. 

3. Press F3 (Exit). 


Viewing the preset address: 


To view the preset address of the remote IOA, do these steps: 

1. Locate a line description that uses the IOA. This description must specify *ADPT in the Adapter 
address field. If you cannot find such a line description, create it, and then return here to continue the 
steps. 

2. Use the Work with Configuration Status (WRKCFGSTS) command to vary on the line description: 

Type WRKCFGSTS “LIN and press Enter. 

Locate your line description and look for a status of varied_on or active. 

If it is varied on or active, press F3 (Exit) and skip to step 

Place your cursor on the Opt field of the line description, type 1 (Vary on), and press Enter. 

If your line description does not vary on, place your cursor on the error message and press F1 

(Help) to view more information about the error. If you need help to understand the error message 


f. Press F3 (Exit). 
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3. Type DSPLIND description_name (where description_name is the name of your line description), and 
press Enter. 

4. Locate the Local adapter address field to view the preset address of the adapter. 

5. Press F3 (Exit). 


Configuration object commands 


You can view and use other commands that affect your line, controller, or device descriptions by using the 
GO command. To do this, do these steps: 

* To view line description commands, type GO CMDLIND and press Enter. 

* To view controller description commands, type GO CMDCTLD and press Enter. 

* To view device description commands, type GO CMDDEVD and press Enter. 


The list below shows other related commands that you can use with your descriptions. To use one of 
these commands, type the name of the command (that is shown in parentheses) and press F4 (Prompt): 
¢ Retrieve Configuration Status (RTVCFGSTS) 

* Vary Configuration (VRYCFG) 

¢ Save Configuration (SAVCFG) 

¢ Restore Configuration (RSTCFG) 

¢ Work with Configuration Status (WRKCFGSTS) 
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Chapter 6. Tune token-ring performance 


You can improve the performance of your connections by adjusting the default values that are contained in 
your controller description. To do this, see]Tuning your LAN performance 
Other performance tips: 


See this information for other tips that may improve the performance of the connection: 
° |Early token release|can decrease transmission delays for 16 Mbps token rings that use half duplex. The 
token-ring line description contains this parameter. 


* You can find other tips in the chapter about communication performance in 
Capabilities Reference % _ The Web site has PDF files that contain the reference. To use the 


reference, you must download the file by clicking on a link and viewing it on your system. You should 
read the disclaimer under the special notice section before using any of the information. 


Tune your LAN performance 


If you change the default values of the LAN parameters, the performance of the connection or system may 


improve. The controller description contains these parameters. For information about these parameters, 
see|SNA over ATM timing information| This asynchronous transfer mode}(ATM)| information also applies to 


LANs. However, you should not use the procedures there to change the parameters. 


To change the LAN parameters, do these steps: 

To view a list of commands that can change your controller description, type GO CMDCHG and press 
Enter. 

From the displayed list of commands, choose a command to change your controller description. 

Type the command and press Enter. 

Change the LAN parameters that you have chosen. 

Press Enter to save your changes. 


— 
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Other performance tips: 


You can also find other performance tips here: 


* Read the chapter about communications performance in|iSeries Performance Capabilities Reference 
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before using any of the information. 


* Read other tips for using SNA over your LAN protocol in|Improving LAN performance 
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Chapter 7. Troubleshooting token ring 


The server has tools to help you locate and resolve errors. This information shows the tools that you can 
use and other troubleshooting help: 


¢ Find your troubleshooting tools in|Troubleshooting LANs 
° If your system or the remote system cannot successfully connect, read|Why some LAN connections fail 


for possible causes and solutions. 


¢ If the PCs cannot connect to your system, see |Why PCs do not connect to your system 

* If you are tracing LAN communications, you may need to know the format of the token-ring frame to 
correctly understand the information it contains. If so, see|Understanding the token-ring address format 

Connection problems when using the 2744 card: 


If you have problems making a connection with the 2744 card, the jautomatic ring-speed sensing} setting 


may be incorrectly configured. If this is the case, you should verify that only the line description or the 
switch to which your system connects is enabled for automatic sensing. That is, only one device must be 
enabled for automatic sensing. The other device should manually indicate the speed it can use. 


Troubleshooting LANs 


Your server has tools to help you quickly find the problem and possible solutions. For an overview of the 


tools of your system and instructions on how to use the tools, see|Getting started with system 
troubleshooting 


Also, you have these tools to help you: 
* [Test|the communications path. 


* |Trace|the network data to locate a problem. 


Note: Although the information in the list pertains to the asynchronous transfer mode (ATM) network, it 
also applies to LANs. 


IBM also provides a Web site that may contain solutions for you, see |Global iSeries Technical Support 


Why some LAN connections fail 


Sometimes an incorrectly configured controller description can cause a connection failure. The cases here 
involve the incorrect configuration of the adapter address, source service access point|(SSAP)} or 


destination service access point |(DSAP)} parameters. 


For more information about how these parameters influence a successful connection, see|How LAN 
devices identify themselves} For other causes of a connection failure, see|Which device initiates the 

The remote system does not connect: 

If your controller description uses|dial mode}, it is not unusual for the system to receive message CPA58E0 
(Controller not replying) or CPA57EF (Contact not successful). Remote systems or controller descriptions 


that do not vary on can cause one of these messages to appear. 


Your system does not connect: 
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If your controller description uses answer mode| you may receive the message CPI591A (Controller is 
online, varied off, or not recognized by the local system). There are some things that can cause this 


message to appear: 

¢ The connection requested by the remote system does not exist on the local system. The local system 
searches for this connection (that is indicated by combining the local adapter address, the DSAP, and 
the SSAP) in all varied-on controller descriptions. 

* The controller description does not refer to the line description that could answer the call. 


Solution: 


To correct any of the above problems, do one or more of these steps: 

¢ On either side of the connection, verify that the controller description has the correct combination of 
adapter address, SSAP, and DSAP. 

¢ Enter the line description that can accept the call into the Switched line list field of the controller 
description. See [Understanding connection establishment] for information about the relationship between 
line descriptions and controller descriptions. 

* Vary on the correct controller description (use the Work with Configuration Status (WRKCFGSTS) 


command to vary on the controller). 
¢ Verify that the local and remote adapters are wired into the network correctly. 


Why PCs do not connect to your system 


If the PCs cannot connect to your server, view the error log for messages about line descriptions and 
about system reference code AFO6 if all these conditions occurred: 

* The remote device is polling your system. 

* The system operator message queue does not contain a message about the system being polled. 
¢ The connection is not established. 


You can verify that the above condition occurred by looking in the error log. Use the Start System Service 
Tools (STRSST) command to look in your error log. To view this log, see[Dieplaving ine Product Acti 
The above condition can occur if the remote device uses a destination service access point[(DSAP)] that 
your line description does not refer to. The condition can also occur if the line description that contains to 
the correct DSAP, is not in the Switched line list field of the correct controller description. Even if the AFO6 


system reference code is absent, the error may have occurred. You can resolve this problem by verifying 
that the adapter address, SSAP, and DSAP values at both ends of the connection are correct. 


Understand the token-ring address format 


While troubleshooting, you may need to view the information of the destination-address and 
source-address frames. These are the formats of the frames: 


Destination address format: 


This figure shows the destination address format: 


32 iSeries: Networking Token-ring on iSeries 


Blt Oo Blt 7 
ln | | ? tod 
SG, L 
Byte 2 
Bit oO Bit 7 
Fa 
ly 
Byte 4 
Blt Oo BRT 


RSI NTA 


Figure 2. Destination address format 


Some of the bits indicate the characteristics of the destination address: 


/G bit (bit 0 of byte 0) indicates the type (individual or group) of the destination address. These are 

the possible values for this bit: 

— 0: The destination address is an individual address (an address that is associated with a device on 
the network). 

— 1: The destination address is a group address (a multiple destination address that is associated with 
one or more devices on the network). 

U/L bit (bit 1 of byte 0) indicates who defined the address. These are the possible values for this bit: 

— 0: The manufacture defined the address (it is a universally administered address or in other words a 
burned-in address). 

— 1: The administrator defined the address (it is a locally administered address). 

Functional address indicator (FAI) bit (bit 0 of byte 2) indicates the address type of the locally 

administered address. These are the possible values for this bit: 

— 0: The address is a functional address. 

— 1: The address is a group address. 


Source address format: 


A source address is always an individual address (that is, an address that is associated with a device on 
the network). This figure shows the format of the address: 
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Figure 3. Source address format 


Some of the bits indicate the type of address that the source address contains: 
* Bit 0 of byte 0 indicates whether or not the frame contains a routing information field. These are the 
possible values for this bit: 
— 0: The routing information field is present. 
— 1: The routing information field is not present. 
¢ Bit 1 of byte 0 indicates the type of the address. These are the possible values for this bit: 
— 0: The address is a universally administered address. Because this bit is 0, the burned-in address 
cannot be greater than X'7FFFFFFFFFFF'. 
— 1: The address is a locally administered address. Because this bit is 1, the group address must be 
greater than X'800000000000'. 
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